home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 390 / applic / quiklabl.doc < prev    next >
Text File  |  1989-04-27  |  7KB  |  158 lines
  1. Documentation for Quick Label 1.0 
  2. =================================
  3.  
  4. (C) 1989 by Ignac A. Kolenko 
  5.  
  6.  
  7. Quick Label runs on any ST, color or mono, with TOS in ROM.
  8. (medium resolution recommended due to dialog box sizes!)
  9.  
  10. To use Quick Label, double click on the file QUIKLABL.PRG. A 
  11. dialog box will appear, and the screen colors will change to 
  12. white, black, red and green (on a color monitor only!). 
  13.  
  14. A set of 10 button, labelled from 0 to 9 are the label editing
  15. buffers. This program allows you to edit 10 labels simultaneously,
  16. which is a great asset for the times you need more than one set of
  17. labels done at one time. To choose a label buffer, simply click
  18. on one of the numbered buttons.
  19.  
  20. Once a buffer has been selected, you can Edit that buffer, or
  21. Load a previously edited label into that buffer. Click either Edit
  22. or Load to perform these function. Editing is described later in
  23. this documentation file. 
  24.  
  25. Also, once a buffer has been selected, you can Save that label (the
  26. standard extender used for labels generated by Quick Label is .LAB)
  27. or clear the label (empty its contents). Clich either Save or Clear
  28. to perform these functions.
  29.  
  30. The final option you have with the currently selected label is to
  31. print it. If you do not load a configuration file, the text will
  32. come out as normal, plain vanilla text (ie: no fancy formatting will
  33. be performed.) So naturally, you will want to load a configuration
  34. file. The configuration file supplied with this program is EPSON.CNF.  
  35. You can double click on this, or  any other properly constructed .CNF file. 
  36. I will discuss how to set up your own .CNF file later in the documentation.
  37. If you choose not to load a configuration file, all printer commands 
  38. will be ignored.
  39.  
  40. Editing is very easy. Clicking on 'Edit' will display a very large
  41. dialog box (the reason this program will not work  as well in low 
  42. resolution is that this box will be chopped off at the sides).  
  43. There are ten lines of forty characters each  for  label 
  44. text, which is plenty for most standard sized labels.  
  45.   
  46. Also, there are three editable fields at the bottom of the screen 
  47. which allow the number of labels, the number of text lines per 
  48. label and the width of the label to be set. Note that the printing 
  49. routines will check the value of the label width field and if it 
  50. is set to zero, that label will not be printed. That is an easy 
  51. way  to pick and choose which labels you don't want printed later 
  52. on.
  53.   
  54. The most obvious feature of this dialog box is the table of control codes
  55. on the right side of the dialog box. This table shows the the control 
  56. character, the graphic symbol the Atari ST displays on the screen after 
  57. the control character is pressed, and the corresponding printer command
  58. it issues. Thus, if you want to make the third line of the label compressed, 
  59. simply cursor down or up to the third line, press <Control>C  
  60. (a right arrow will appear), type in your text, and press <Control>N 
  61. to return to normal print (the left half of the Atari symbol  will  appear). 
  62. Thus, when the label is printed, the third line will be output in 
  63. the printer's compressed mode. It is just as easy to use any of 
  64. the printer's control codes in the same manner as above. Load in EXAMPLE.LAB
  65. supplied in the arc'ed file to see most of the control codes in action.
  66.   
  67. When ready to print a label, simply go and click on 'Print One'. This will 
  68. output the specified number of labels with the specified number of lines per 
  69. label as typed in the edit dialog. If you wish to output all the labels 
  70. in memory at once, just click on 'Print All' under Label. As stated above,  
  71. a label with  the  label  width set to zero will  not  be  printed,  which 
  72. insures that if you only have two labels in  memory, only two 
  73. labels will be printed, since the rest of the labels are  zeroed 
  74. out.  
  75.  
  76. To clear out a label so that another may be started from  scratch, 
  77. just click on 'Clear' under Label. The three numerical fields will 
  78. be reset to zero, and the label text will be reset to null. You do 
  79. not need to do this if you are loading a label, since loading will 
  80. obliterate what was there automatically.
  81.  
  82.  
  83. HOW TO CREATE YOUR OWN CONFIGURATION FILE
  84. -----------------------------------------            
  85.  
  86. It is easiest to study a few lines from the EPSON.CNF file supplied with 
  87. this program to help create your own  configuration file. The first two 
  88. lines appear as such:
  89.  
  90. 27,69;          A       Emphasized print on
  91. 27,70;          B       Emphasized print off
  92.  
  93. The numbers on the left of each line are the printer control codes. For 
  94. instance, to turn emphasized print on on an Epson printer, you need to 
  95. send it an escape 'E' sequence. By checking the ASCII codes for escape and 
  96. 'E' (published in almost all computer books and manuals), we see that escape 
  97. is 27 and 'E' is 69. Each separate control code must be separated by a 
  98. comma, and when the control sequence is done, a semicolon must be present if 
  99. you wish to make comments on the same line. 
  100.  
  101. Still with the example above, after the semicolon, I have typed the letter 
  102. 'A'. This is just a reminder to everyone that the first line corresponds 
  103. to <control>A in the label edit menu choice (you can check there if you 
  104. want to verify). Finally, I typed  in  a description  of  what these 
  105. codes do for each control sequence, allowing you to easily locate the 
  106. code sequences you want to change.
  107.  
  108. A few other words of warning about this file: firstly, there must be no 
  109. carriage returns before the first line, since the program will read in only
  110. the first twenty-six lines of the configuration file. Any additional
  111. comments may  be placed after the last control sequence, starting on line 27
  112. of the configuration file, like I have. Also, only five control codes per 
  113. line are allowed. Finally, configuration files from other programs 
  114. will not work with this one,  since most are printer drivers.
  115.  
  116. Pay for shareware and receive updates!
  117. --------------------------------------
  118.  
  119. At this time, we would like to receive some user feedback before we go
  120. ahead and implement any new features. What else you you like to see in this
  121. "super label editor"?
  122.  
  123. As a registered user of this program, you will receive the rest of the 
  124. Quick family of quality shareware:
  125.  
  126. Quick Find  - fast file finder
  127. Quick Inf   - desktop information editor
  128. Quick View  - fast text viewer
  129. Quick Print - text only screen dumper (significantly faster 
  130.               than graphics dump)
  131. Quick Index - the de-facto benchmark for the Atari ST
  132. Quick ST    - fast VT52 and GEM speedups
  133.  
  134. To become a registered user, send a $30 (if you wish only to receive
  135. Quick ST, send $20) check or money order to:
  136.  
  137.     Darek Mihocka
  138.     Box 2624, Station B
  139.     Kitchener, Ontario  N2H 6N2
  140.     Canada
  141.  
  142. You can reach us by modem on the following networks:
  143.  
  144. Ignac Kolenko:
  145.     Usenet: watmath!watcgl!electro!ignac
  146.  
  147. Darek Mihocka:
  148.     Compuserve: 73657,2714
  149.     BIX, Delphi, GEnie: DAREKM
  150.  
  151. both:
  152.     Usenet: watmath!watcgl!oaee455s
  153.  
  154. We thank you for supporting shareware and encourage you to support other
  155. shareware authors. You may distribute copies of Quick Label
  156. under the condition that you also include this documentation file. You may
  157. not charge a fee or in any way try to sell this software.
  158.